MacPPP Timer is a utility application to be used with MacPPP that allows you to keep track of how much time you spend on your PPP account. MacPPP must be properly installed on your computer for it to work. MacPPP Timer requires System 7.0 or later.
What it does
When you launch by double-clicking, a small, draggable timer window appears under the Trash. When the timer window is dragged to a new position, the new position is saved and becomes the default position the next time the timer is launched. The blue numbers, on top, display the time for the current session, while the red numbers, below, record cumulative time. The cumulative time can display cumulative time for the current day, cumulative time for the month beginning on a day you select, or cumulative time since you last manually cleared the register. By default, the cumulative time keeps incrementing until you manually clear it. By clicking on the cumulative time in the timer window, the display will toggle between cumulative for the day ( displayed like this: 00:00:05 ) or cumulative total/month (displayed like this: 00:00:05 ). Cumulative times and other settings are automatically saved once per minute to provide some protection against loss of data should the computer crash during a timed session.
The Menus
You can initiate your MacPPP session either by selecting "Begin Session" from the MacPPP Timer file menu or by connecting using the MacPPP control panel. MacPPP Timer waits patiently until MacPPP signals that the connection is established, then begins to time your session. You can use the start of the timer to confirm that your connection is established. Selecting "End Session" from the File menu, breaks your PPP connection and turns the timer off. Selecting "Clear Monthly" will terminate your session and set monthly cumulative time to zero. Selecting "Clear Daily" will terminate your session and set daily cumulative time to zero. Selecting Preferences... will open the Preferences dialog (see below). Selecting "Quit," terminates your PPP session and quits the program. MacPPP Timer always ends a session with hard close.
The Preferences Dialog
If you check Auto Clear in the Preferences dialog, the cumulative time will automatically clear on the day of the month that you choose (first day of the month is the default). The Preferences dialog allows the day for Auto Clear to be changed and also displays the previous month's total usage. This is handy if you are billed by your provider by monthly usage and you want to know how much you have used. If "Auto Launch" is checked, MacPPP Timer will automatically signal MacPPP to connect to your currently configured host the next time you launch MacPPP Timer. If "Display Daily" is checked, the timer window will display the daily cumulative time by default each time you launch. Cumulative times can be cleared from the Preferences dialog.
Shortcuts
There are four shortcuts to save trips to the menu bar. The timer window has four " Hot Spots" indicated by the darker gray shading in the corners. The upper left Hot Spot, when clicked, will Begin a session. The lower left will End the session. The lower right will Quit. The upper right spot will open the Preferences dialog.
The Deal
MacPPP Timer is discetionary shareware. If you find that you use it a lot and feel that it is worth $5, by all means send it. If you feel like sending a nice letter or postcard, do that. If you want to send a shareware product of your own, please do! If you don't feel like sending anything, don't send anything. There are no annoying registration dialog boxes full of accusatory language getting in your face or anything like that.
Send your cash, checks (US$ drawn on a US bank), postal money orders, postcards, letters, disks, bug reports, etc., to:
Eric Preston
23547 Clark Dr.
Philomath, OR 97370
USA
Internet email: ericpresto@aol.com
America Online: EricPRESTO
Acknowledgements
Richard Buckle generously provided the code for the MacPPP interface and helped catch several bugs in earlier versions. If you have questions about the MacPPP interface, please contact Richard directly at: richardb@cocytus.demon.co.uk. Matt Train and Ryan Walker tested version .1ß. Frank Garcia found and reported the window bug in version 1.1. The window hot spots are courtesy of Florian. Richard Lesnick caught the preferences dialog bug in version 1.2
Limitations on Distribution
MacPPP Timer is copyrighted to Eric Preston, 1995, and may not be sold or distributed for profit in any form, either with other products (commercial, shareware, or freeware), or in shareware/freeware collections sold for profit, without my prior written consent. MacPPP Timer may be distributed freely provided it is distributed in a non-profit manner, and is provided in its original unmodified form. However, please notify me if it is to be included in non-profit collection on disk, CD ROM, or other media.
Disclaimer
The author makes no warranties, either express or implied, regarding MacPPP Timer. Use of MacPPP Timer is at your own risk. The author claims no liability for data loss or other problems caused directly or indirectly by MacPPP Timer.
YetAnother Timer and InterSLIP Timer
If you do not use MacPPP, but otherwise have use for the features in MacPPP Timer, download YetAnother Timer from the Applications directory at info-mac or any of its mirrors. It has all of MacPPP Timer's features except the MacPPP interface. InterSLIP Timer has all of the features of MacPPP Timer, but with an InterSLIP interface. It can be found in the Communications/MacTCP directory.
Known Bugs and Incompatibilities
I've been alerted that a bug in MacPPP will cause MacPPP Timer to crash if you use the
MacTCP control panel to switch out of PPP while MacPPP Timer is running. A couple users have reported intermittent trouble closing the connection from MacPPP Timer. I'm not yet sure if this is a problem with the timer or with MacPPP. Two users have reported spontaneous auto-initiation of the connection and felt that MacPPP Timer might have been the culprit. I haven't been able to reproduce this and have put nothing in the code that should cause this to happen. MacPPP does seem to be full of tricks. Bug reports are welcome.
Version History
Version 1.0 ß- January 31, 1995.
Version 1.1 - February 5, 1995. First Public Release.
Version 1.1.1 - February 12, 1995. Fixed bug which caused window position not to be
saved after "Quit" from the File menu.
Version 1.1.2 - March 5, 1995. Fixed a bug which caused incorrect tally of cumulative
time on some systems.
Version 1.2 - April 20, 1995. Added daily cumulative timer. Enlarged "Hot Spots".
Cumulative time is now saved once per minute to minimize data loss if
a computer crash occurs during a session. Additional checking at startup
to make sure timer window is correctly placed on the current device.
Menu conforms with Apple Guidelines.
Version 1.2.1 - April 21, 1995. Fixed a bug in the preferences dialog which caused the
screen to be redrawn incorrectly when cumulative time was cleared.
